home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / MrmFetchSetValues.z / MrmFetchSetValues
Encoding:
Text File  |  2003-11-18  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _M_r_m_F_e_t_c_h_S_e_t_V_a_l_u_e_s - Fetches the values to be set from
  10.       literals stored in UID files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Mrm/MrmPublic.h>
  14.  
  15.       Cardinal MrmFetchSetValues(hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,,,, wwwwiiiiddddggggeeeetttt,,,, aaaarrrrggggssss,,,, nnnnuuuummmm____aaaarrrrggggssss)
  16.            _M_r_m_H_i_e_r_a_r_c_h_yhhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd;
  17.            _W_i_d_g_e_t     wwwwiiiiddddggggeeeetttt;
  18.            _A_r_g_L_i_s_t     aaaarrrrggggssss;
  19.            _C_a_r_d_i_n_a_l     nnnnuuuummmm____aaaarrrrggggssss;
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.       The _M_r_m_F_e_t_c_h_S_e_t_V_a_l_u_e_s    function is similar to _X_t_S_e_t_V_a_l_u_e_s,
  23.       except that the values to be set are defined by the UIL
  24.       named    values that are    stored in the UID hierarchy.
  25.       _M_r_m_F_e_t_c_h_S_e_t_V_a_l_u_e_s fetches the    values to be set from literals
  26.       stored in UID    files.
  27.  
  28.       hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd
  29.            Specifies the ID    of the UID hierarchy that contains the
  30.            specified literal. The hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd was returned    in a
  31.            previous    call to    _M_r_m_O_p_e_n_H_i_e_r_a_r_c_h_y_P_e_r_D_i_s_p_l_a_y.
  32.  
  33.       wwwwiiiiddddggggeeeetttt
  34.            Specifies the widget that is modified.
  35.  
  36.       aaaarrrrggggssss Specifies an argument list that identifies the widget
  37.            arguments to be modified    as well    as the index (UIL
  38.            name) of    the literal that defines the value for that
  39.            argument.  The name part    of each    argument
  40.            (args[n].name) must begin with the string _X_m_N followed
  41.            by the name that    uniquely identifies this attribute
  42.            tag.  For example, _X_m_N_w_i_d_t_h is the attribute name
  43.            associated with the core    argument wwwwiiiiddddtttthhhh.     The value
  44.            part (args[n].value) must be a string that gives    the
  45.            index (UIL name)    of the literal.     You must define all
  46.            literals    in UIL as exported values.
  47.  
  48.       nnnnuuuummmm____aaaarrrrggggssss
  49.            Specifies the number of entries in aaaarrrrggggssss.
  50.  
  51.       This function    sets the values    on a widget, evaluating    the
  52.       values as public literal resource references resolvable from
  53.       a UID    hierarchy.  Each literal is fetched from the
  54.       hierarchy, and its value is modified and converted as
  55.       required.  This value    is then    placed in the argument list
  56.       and used as the actual value for an _X_t_S_e_t_V_a_l_u_e_s call.
  57.       _M_r_m_F_e_t_c_h_S_e_t_V_a_l_u_e_s allows a widget to be modified after
  58.       creation using UID file values exactly as is done for
  59.       creation values in _M_r_m_F_e_t_c_h_W_i_d_g_e_t.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       As in    _M_r_m_F_e_t_c_h_W_i_d_g_e_t,    each argument whose value can be
  75.       evaluated from the UID hierarchy is set in the widget.
  76.       Values that are not found or values in which conversion
  77.       errors occur are not modified.
  78.  
  79.       Each entry in    the argument list identifies an    argument to be
  80.       modified in the widget.  The name part identifies the    tag,
  81.       which    begins with _X_m_N.  The value part must be a string
  82.       whose    value is the index of the literal.  Thus, the
  83.       following code would modify the label    resource of the    widget
  84.       to have the value of the literal accessed by the index
  85.       OK_button_label in the hierarchy:  args[n].name = XmNlabel;
  86.       args[n].value    = "OK_button_label";
  87.  
  88.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  89.       This function    returns    one of these status return constants:
  90.  
  91.       _M_r_m_S_U_C_C_E_S_S
  92.            The function executed successfully.
  93.  
  94.       _M_r_m_P_A_R_T_I_A_L__S_U_C_C_E_S_S
  95.            At least    one literal was    successfully fetched.
  96.  
  97.       _M_r_m_B_A_D__H_I_E_R_A_R_C_H_Y
  98.            The hierarchy ID    was invalid.
  99.  
  100.       _M_r_m_F_A_I_L_U_R_E
  101.            The function failed.
  102.  
  103.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  104.       _M_r_m_O_p_e_n_H_i_e_r_a_r_c_h_y_P_e_r_D_i_s_p_l_a_y(_3_X), _X_t_S_e_t_V_a_l_u_e_s(_3_X).
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.